home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / prefix.man < prev    next >
Text File  |  1992-03-25  |  4KB  |  94 lines
  1. ' $Header: /sprite/src/cmds/prefix/RCS/prefix.man,v 1.4 92/03/25 15:53:24 shirriff Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS PREFIX cmds
  4. .BS
  5. .SH NAME
  6. prefix \- Manipulate the file system prefix table
  7. .SH SYNOPSIS
  8. \fBprefix\fR [\fB\-p\fR [\fB\-x \fIprefix\fR]]\fR
  9. .br
  10. \fBprefix\fR \fB\-M \fIdevice\fR \fB[-rL] [-f] -l \fIprefix\fR
  11. .br
  12. \fBprefix\fR \fB\-[cdU] \fIprefix\fR
  13. .br
  14. \fBprefix\fR \fB\-a \fIprefix\fR [\fB\-s\fR \fIserver\fR]
  15. .br
  16. \fBprefix\fR \fB\-x \fIprefix\fR \fB\-[hH] \fIhost\fR
  17. .br
  18. \fBprefix\fR \fB\-x \fIprefix\fR \fB\-l \fIlocalName\fR
  19. .SH "OPTIONS"
  20. .IP "\fB\-p\fR" 14
  21. (The default.) Print out the prefix table.
  22. With \fB\-x\fR, print the export list of a prefix.
  23. .IP "\fB\-x \fIprefix\fR" 14
  24. Export a local directory given by \fB\-l\fR under the name \fIprefix\fR,
  25. or use with \fB\-h\fR (\fB\-H\fR) to export (not export) the prefix 
  26. to a particular host.
  27. .IP "\fB\-M \fIdevice\fR" 14
  28. Mount the device under the local name given by the \fB\-l\fR option.
  29. The local name is exported.
  30. .IP "\fB\-L\fR" 14
  31. Use with \fB\-M\fR to prevent exporting the prefix.
  32. .IP "\fB\-r\fR" 14
  33. Mount read-only.  Use with \fB\-M\fR.
  34. .IP "\fB\-U \fIprefix\fR" 14
  35. Unmount the file system with the given prefix.
  36. .IP "\fB\-f\fR" 14
  37. Force the installation of the prefix, i.e. don't do a stat to make sure
  38. the link exists.
  39. .IP "\fB\-l \fIdirName\fR" 14
  40. Specifies local name.  Used with \fB\-M\fR (mount) or \fB\-x\fR (export).
  41. .IP "\fB\-h \fIhost\fR" 14
  42. Add \fIhost\fR to the export list associated with the prefix given
  43. by the \fB\-x\fR option.
  44. \fIHost\fR can either be the name of the server or its Sprite ID.
  45. .IP "\fB\-H \fIhost\fR" 14
  46. Remove \fIhost\fR from the export list associated with the prefix given
  47. by the \fB\-x\fR option.
  48. \fIHost\fR can either be the name of the server or its Sprite ID.
  49. .IP "\fB\-a \fIprefix\fR" 14
  50. Add \fIprefix\fR to the prefix table. If the \fB\-s\fR option is not
  51. given a broadcast will be done to find the server.
  52. .IP "\fB\-s \fIserver\fR" 14
  53. Specify the server for the prefix given by the \fB\-a\fR option.
  54. \fIServer\fR can either be the name of the server or its Sprite ID.
  55. If \fIserver\fR is 0 a broadcast will be done to find the server.
  56. .IP "\fB\-c \fIprefix\fR" 14
  57. Clear the server binding for \fIprefix\fR, but retain the prefix in
  58. the prefix table.
  59. .IP "\fB\-d \fIprefix\fR" 14
  60. Delete \fIprefix\fR from the prefix table altogether.
  61. .BE
  62.  
  63. .SH DESCRIPTION
  64. .PP
  65. Prefix tables are cached mappings from file name prefixes to the
  66. servers that keep files under that prefix.   Under normal operation
  67. the prefix table is updated automatically as a side-effect of
  68. pathname lookup.  The \fBprefix\fP command is used to display the file system's
  69. prefix table,
  70. and to manipulate its individual entries.  If no options are given,
  71. prefix prints out the contents of the prefix table (just as if the
  72. \fB\-p\fR switch had been given).  If options are given, then they
  73. control what happens, as described above.
  74. .SH PREFIXES AND SPRITE
  75. .PP
  76. The presense of a prefix is indicated by remote links in the file system.
  77. A remote link is a circular symbolic link with a special type.   They
  78. are created via the "ln -r" command.  When a server encounters a remote
  79. link during lookup, it returns the prefix indicated by the remote link to
  80. the client that initiated the lookup.  The client loads the prefix (if it
  81. isn't already loaded), broadcasts for the server of the prefix (if it doesn't
  82. already know who that is), and then sends the lookup operation to the
  83. new server.  Thus the root server is bypassed after prefixes are loaded.
  84. Prefixes can be nested arbitrarily; remote links can occur in any directory.
  85. .PP
  86. Servers mount local disks under a prefix that
  87. gets exported to other Sprite hosts using the -M option.  Servers
  88. can control what hosts have access to a prefix by adding entries
  89. to an export list using the -h option.  If the export list is
  90. empty the prefix is exported to all hosts, so adding one exportee
  91. effectivly prevents access to all other hosts.  
  92. .SH KEYWORDS
  93. prefix table, mount
  94.